…y at build/package time

The init command wrote several project files in ways that leaked internal
detail or clobbered consumer formatting:

- CLAUDE.md received the entire CLAUDE.snippet.md template, including the
  human-facing "paste the block below" instructions and marker comments.
  Extract and install only the block between the markers.
- The CLAUDE.md idempotency guard also matched the loose phrase
  "wherefore plugin"; drop it and key only on the "## Wherefore" heading we
  actually write.
- The .gitignore de-dupe used substring matching, so an existing
  `frontend/dist/` (or the internal `.test-dist/`) masked a missing
  top-level `dist/`. Match whole lines instead.
- `.test-dist/` is this package's own test-output dir and meaningless to a
  consumer; stop adding it to their .gitignore.
- Adding the devDependency reformatted the consumer's package.json to
  2-space with no trailing newline. Detect and preserve the existing
  indentation and trailing newline.

Adds targeted regression tests for the gitignore line-match, the CLAUDE.md
paste-instruction exclusion, and package.json format preservation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Two robustness gaps in the init command:

- The topics.md / package.json / AGENTS.md / CLAUDE.md steps swallowed
  errors as warnings, so init printed "Initialization complete!" and exited
  0 even when a write genuinely failed. Track a hadError flag across those
  steps (and the skill install) and exit 1 at the end if anything errored;
  "already exists / skipped" is not an error.
- On --force, the skill install ran `rm(dest)` before `cp`, so a failed
  copy left the skill deleted with no replacement. Copy into a temp dir and
  rename it into place, so dest is only removed once the new copy exists.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

prepare-package.js unconditionally rm+recopied skills/ and templates/ on
every dev/build/test invocation, and would hard-fail if the monorepo sources
were absent.

- Guard: when the plugin sources are missing (e.g. an installed package),
  no-op if the assets are already present rather than crashing; warn if both
  are missing.
- Cache: skip the rebuild when the generated assets are already newer than
  every source. Any error in the freshness check falls through to a full,
  correct rebuild, so a stale skip is not possible.

Also add a prepublishOnly script alongside prepack so publish reliably
regenerates the shipped assets.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- The global and local skill-install branches were ~20 lines of identical
  logic differing only in target dir and "global"/"local" wording. Collapse
  to one loop parameterized by a scope label and skillsDir.
- parseArgs never stores the string 'true' for the boolean --global/--force
  flags, so the `flags.global === 'true'` / `flags.force === 'true'`
  disjuncts were dead; the rawArgs.includes checks already do the work.

No behavior change; global and local installs verified.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

init scaffolds a wherefore/plan/ directory that the documented layout did not
list. Keep it as a home for forward-looking plans and add it to the directory
layout so the scaffolding matches the docs. AGENTS.md is also the template init
installs, so consuming projects get the updated layout too.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Introduce packages/wherefore, a dependency-light CLI published as `wherefore`
(npx wherefore init). Separating it from the astro-heavy dashboard keeps init
fast and fixes the "dashboard" positioning of the old init command.

- `init` scaffolds wherefore/, writes the AGENTS.md cross-tool floor + a
  CLAUDE.md snippet, and pins a `wherefore` devDependency. Skills are now
  OPT-IN (--skills / --agent / --global), not installed by default, keeping
  AGENTS.md as the always-on cross-tool surface.
- Multi-agent skill targeting via --agent <list|all|auto>: claude ->
  .claude/skills, codex -> .codex/skills, copilot/cursor/gemini/antigravity ->
  the shared .agents/skills path; --global maps to the ~/ equivalents. Unknown
  agents error. Reuses the atomic temp-swap install and aggregate exit-1.
- `dashboard` is a thin launcher that spawns @dustinvk/wherefore-dashboard on
  demand (overridable via WHEREFORE_DASHBOARD_BIN), so `wherefore` needs no
  astro dependency.
- prepare-package.js (moved) generates skills/ + templates/ from the single
  plugins/wherefore source at build/pack time.

13 tests cover default-off skills, per-agent/all/auto/unknown/global/force
paths, the launcher, and the CLAUDE.md/gitignore/package.json regressions.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

The dashboard package is a static-site build tool; scaffolding a project and
installing agent skills now live in the standalone `wherefore` CLI. Revert the
dashboard to build/dev only:

- Remove the init command (a redirect points users to `npx wherefore init`).
- Delete bin/prepare-package.js and drop skills/templates from `files`, the
  `.gitignore`, and the dev/build/test/prepack/prepublishOnly scripts.
- Remove the init tests (they moved to packages/wherefore); keep build/dev.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- README: add the `wherefore` CLI to the ways-to-work list, a "Setting up a
  project" section covering `npx wherefore init` and the opt-in --skills/--agent
  flags, and the new package in the repo layout.
- dashboard README: note that project setup / skill install lives in the
  `wherefore` CLI.
- Capture the decision in the log: 2026-07-03-wherefore-cli-and-multi-agent-skills
  (lean CLI split, opt-in multi-agent skills, AGENTS.md-floor-stays-default) plus
  open question Q-008 on whether to ship per-agent skills at all.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Covers what npm test can't: running the packaged tarball as a user would, the
robustness/idempotency paths, the real dashboard launcher, and per-agent
verification that an installed SKILL.md is actually discovered by Claude Code,
Codex, Cursor, Copilot, Gemini, and Antigravity.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Capture the grilling decision to keep the init-scaffolded wherefore/plan/
directory (rather than remove the orphaned dir) and document it as the home
for forward-looking plans, the counterpart to log/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>